home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / c / stuffky.exe / README.TXT < prev    next >
Text File  |  1991-07-17  |  4KB  |  81 lines
  1. Hello.
  2. The files included in this archive (ziphive?) are intended to  instruct
  3. the reader on the operation of the keyboard buffer in IBM compatible  &
  4. ZDS computers.
  5.  
  6. File Name      Description
  7. ---------      -----------
  8. readme.txt     This file.
  9. stuffkb3.asm   Re-Edited version of Stuffkb2.asm. Contains information
  10.                on the operation of the keyboard buffer & sample ASM &
  11.                TC routines.
  12. keyboard.C     Contains small routines regarding the keyboard buffer
  13.                which I have found useful.
  14. Please keep in mind that the author assumes no liability for the use of
  15. any supplied information/software.
  16.  
  17. Regarding the files:
  18. Regardless of  whether  or  not  you  intend  to  program  in  Assembly
  19. language, you should be sure to examine the file STUFFKB3.ASM since  it
  20. contains detailed information on the keyboard buffer. (The  information
  21. is in the form of extensive comments.)
  22. In case your wondering why I choose to supply the information inside an
  23. assembly language listing, there is a reason. I had originally intended
  24. to upload the .asm file without achievement in the hope  of  making  it
  25. easier for you to read (either on or off line). Without  achievement,  I
  26. could only upload one single file, hence my inclusion of virtually  all
  27. the information in the .asm file.
  28. You might also wonder why an .asm file was uploaded into the C library.
  29. There are two reasons:
  30. 1) The original version was uploaded here (for reason's that escape  me
  31. now).
  32. 2) The informative nature of the .asm file (most of its volume consists
  33. of comments) combined with the included Turbo C sample calling  routine
  34. seem to make it well suited for  this  library.  For  those  who  would
  35. prefer not to program in ASM but rather C (or Basic, for  that  matter)
  36. you should be able to easily extract enough information from  the  .asm
  37. file to write your  own  similar  but  even  better  routines  in  your
  38. favorite language.
  39.  
  40. "Extensively tested?": This information has  been  accumulated  largely
  41. for the benefit of others. Aside for the keyboard clearing routine (which
  42. I have found quite handy) I have not personally used or had  reason  to
  43. use any of the keyboard buffer stuffing routines.  Do  extensively  test
  44. any routines to make sure that they work satisfactorily for  you.  If
  45. you find any problems do write!
  46.  
  47. Regarding feedback: If you discover any errors in these  files  or  can
  48. add to the information contained within, feel free to drop me a note:
  49. Richard Kanarek
  50. Compuserve: 72371,111
  51. GEnie:      R.KANAREK
  52.  
  53. "Avoiding problems/Misc. information":
  54. -All .asm source code was written for compilation by  Turbo  Assembler*.
  55. All .c source code was written for compilation by Turbo C*.  All  source
  56. code should compile without errors or  warnings  unless  you  have  the
  57. "Function should return a value" ANSI compatibility turned on (which I
  58. doubt  most  people  would).  Compiling  source  code  with  MASM**  or
  59. Microsoft/Quick/Whateveritscalled/C**  should  not   pose   a   serious
  60. problem.
  61. -Do remember to assemble the .asm file (after editing  it  as  needed!)
  62. with TASM's /MX option enabled or proc's declared in the .asm file  and
  63. extern'ed in your C program(s) might not be found @ link time.
  64. -Do take head of my warning in the .asm file regarding writing your own
  65. keyboard stuffing routines- They probably won't work the first time  you
  66. try them and if they don't work they can turn ugly! Do save all work in
  67. progress before testing you latest "debugged" software work of art!
  68.  
  69. Enjoy!
  70.  
  71.  
  72.  
  73. *=  Product of Borland International Inc.
  74. **= Product of Microsoft Inc.
  75.  
  76.  
  77.  
  78. Richard Kanarek
  79. 7/17/1991
  80.  
  81.